package com.vegetable.modules.mapper.finance;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.vegetable.modules.entity.finance.TransactionPaymentMatch;
import com.vegetable.modules.entity.finance.vo.TransactionPaymentMatchVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.util.List;

/**
 * <p>
 * 交易流水与付款记录匹配关系 Mapper 接口
 * </p>
 *
 * @author Qoder
 * @since 2025-11-02
 */
@Mapper
public interface TransactionPaymentMatchMapper extends BaseMapper<TransactionPaymentMatch> {

    /**
     * 根据付款记录ID查询关联的所有交易流水
     * @param paymentId 付款记录ID
     * @return 匹配关系列表
     */
    List<TransactionPaymentMatchVO> selectByPaymentId(@Param("paymentId") Long paymentId);

    /**
     * 根据交易流水ID查询关联的付款记录
     * @param transactionId 交易流水ID
     * @return 匹配关系列表
     */
    List<TransactionPaymentMatch> selectByTransactionId(@Param("transactionId") Long transactionId);

    /**
     * 根据付款记录ID查询已匹配的总金额
     * @param paymentId 付款记录ID
     * @return 已匹配的总金额
     */
    BigDecimal selectMatchedAmountByPaymentId(@Param("paymentId") Long paymentId);
    
    /**
     * 根据交易流水ID查询已匹配的总金额
     * @param transactionId 交易流水ID
     * @return 已匹配的总金额
     */
    BigDecimal selectMatchedAmountByTransactionId(@Param("transactionId") Long transactionId);
    
    /**
     * 根据付款记录ID查询关联的所有交易流水利息（包含交易流水信息）
     * @param paymentId 付款记录ID
     * @return 匹配关系列表（包含交易流水信息）
     */
    List<TransactionPaymentMatch> selectByPaymentIdWithTransactionInfo(@Param("paymentId") Long paymentId);

    /**
     * 根据交易流水ID查询关联的付款记录（包含付款记录信息）
     * @param transactionId 交易流水ID
     * @return 匹配关系列表（包含付款记录信息）
     */
    List<TransactionPaymentMatch> selectByTransactionIdWithPaymentInfo(@Param("transactionId") Long transactionId);

    /**
     * 删除指定付款记录与交易流水的关联关系
     * @param paymentId 付款记录ID
     * @param transactionId 交易流水ID
     * @return 删除的记录数
     */
    int deleteByPaymentIdAndTransactionId(@Param("paymentId") Long paymentId, @Param("transactionId") Long transactionId);
}